Skip to content

Isolate managed Codex workers from Core writeback - #9129

Open
hhyykk wants to merge 1 commit into
mainfrom
codex/worker-isolation-pr-20261120
Open

hhyykk wants to merge 1 commit into
mainfrom
codex/worker-isolation-pr-20261120

Conversation

@hhyykk

@hhyykk hhyykk commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator

Goal And Delivered Outcome

背景

LoopX 保存任务状态、授权和结算回执,Codex 等宿主负责调用模型和工具。如果 Worker 与 Core 共用系统账号,Worker 可能直接改写注册表或运行目录。宿主重启、压缩会话或继续执行旧计划时,实际操作就可能偏离 LoopX 的当前授权。

目标

让 LoopX Core 掌握受管工作的正式写回权。Worker 可以读取任务、执行检查和提交候选结果。Core 在写回前核对当前授权。同一个 Turn 重试时沿用原操作身份和回执,避免重复写入和扣额。

做什么

  1. 隔离 Worker 进程。 在受管 Codex 路径增加可选的独立低权限 Linux 账号。Worker 使用自己的 Codex 目录和模型凭据。Core 的环境变量不会传入 Worker。
  2. 保护权威目录。 注册表目录和运行目录由 Core 私有持有。Worker 使用只读沙箱,通过现有受管接口提交结果。
  3. 在写回处检查授权。 Core 在正式写入前重新检查 Goal 状态,复用现有 Turn 日志和回执处理恢复和重试。

收益

写入资格由系统权限和 Core 的写回检查共同执行。端到端用例验证了 Worker 直写被拒、同一个 Turn 重试不追加第二次,以及在写回检查处发出 Stop 后没有写入或扣额。

风险

  • 启动权限。 当前需要以 root 运行 Linux Core 启动器,才能把 Worker 切换到低权限账号。评审请确认是否接受这项部署前提,以及由谁维护权限。
  • 接入范围。 本次覆盖受管 Codex 的本地持久写回。飞书等外部写入需要在各自的适配器中管理凭据和检查授权。请求已发出但结果不明时,需要先读回对账。
  • 切换与回退。 Worker 身份参与会话绑定。启用或撤回此配置时,需要在目标环境核对原会话的处理方式,以及启动、停止和恢复行为。

请主负责人确认当前权限边界是否可接受,以及是否适合先在一条受管链路上试用。此 PR 的目标分支是 main。

Author Declaration

  • Written by OpenAI Codex, a GPT-6.2 model agent.

Implemented against

  • No separate written specification. The scoped request in this PR is the basis.
Criterion Disposition Symbol / path Evidence
Use a distinct nonprivileged Linux identity for the selected Worker implemented loopx/control_plane/turn_driver/codex_worker_identity.py and the managed Codex launch Real subprocess UID, group, privilege and inherited environment checks
Preserve Core ownership of local authoritative writes implemented Managed operation host and Codex durable writeback Actual filesystem denial, original-Turn replay and Stop-at-writeback cases
Qualify deployment, other hosts and external business writes out_of_scope Single managed Codex local writeback Separate host and write-adapter validation required
  • Self-check covered the launch identity, protected registry and runtime directories, authorization at durable writeback, existing receipt semantics, and operator instructions.

Scope And Continuation

Validation

  • Tested revision c179a1eafa8cbb2a093b89e29b100c780ce2203d.
  • Run state finished.
  • Input class synthetic.
Check kind Result Public-safe evidence / limitation
integration passed 60 tests passed and two opt-in live-host release tests skipped in the managed host, first-party admission and typed writeback suite. The subprocess fixture used real Linux account permissions and the real local writeback path.
static passed Ruff on changed Python files and committed diff whitespace checks.
regression_parity passed Quick premerge passed at the prior local head. The patch ID is identical after rebasing onto the current main. Focused runtime and maintainability checks were rerun on the exact PR head.
  • Live-provider behavior, production deployment, and external business write adapters remain outside the validated scope.

Frontend / Visual Evidence

  • UI impact is none.

Type of Change

  • New feature
  • Documentation update
  • Test update

LoopX Area

  • Control plane
  • Host or runtime integration

Boundary Checklist

  • Public-safe evidence only.
  • Existing open proposals were checked for duplicate work.
  • No paired RFC changed.
  • UI impact is none.
  • The commit has a DCO sign-off.

Signed-off-by: Codex <codex@openai.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 20, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-20T06:17:45.176888Z c179a1e PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · Gemini · Google DeepMind · self_reported

审阅目标:loopx-project/loopx#9129(精确提交 c179a1eafa8cbb2a093b89e29b100c780ce2203d)

动机 / Motivation

使用 Linux Core 服务并通过 --codex-operation-tools 运行受管 Codex Worker 的运维方与 Turn 驱动调用方。 改动前受管 Codex 子进程沿用 Core 宿主身份;改动后通过环境变量开启 Linux 隔离时,启动期加载独立 Worker 身份并以 setpriv --no-new-privs 降权运行,写回阶段检查 isolated_codex_durable_writeback。但当前实现遗漏了非终结 validated_completion 的 completion_writeback 分支(实测 2-Todo 场景未触发该校验即提交写回与配额),且新增测试在 macOS 与非 root 环境整组跳过。 当前在 macOS 上显式开启隔离环境变量会在启动校验阶段 fail-closed 报错;而在已通过 mock/真实 CLI 触发的 2-Todo validated_completion 写回路径上,目前可观察到 state_written=True 且 REQUIRE_RUNNING_OPS=['codex_cli_turn_settle'](尚未拦截绕过问题)。 本 PR 不在 macOS/Darwin 提供 OS 级 setpriv 降权隔离,也不修改普通无隔离默认路径下的既有 Codex 会话模型。

改动思路 / Approach

作者将整个隔离机制拆分为“启动期 OS 降权与目录隔离”及“提交期 Core 写回门禁”两段:在启动受管 Codex 前校验 Linux root 与独立的非特权 worker 账号、0o700 私有目录和 setpriv --no-new-privs,并禁用可写沙箱、自定义 MCP Server 与遗留来源回退;在写回 Core 状态前则试图通过 goal_admission.require_running(operation='isolated_codex_durable_writeback') 二次核验 Goal 仍处于运行状态。

将 Linux Worker 降权边界收敛在 codex_worker_identity 与 codex_operation_host 并复用 FirstPartyHostGoalAdmission 的整体分层方向正确,但当前 turn_run_once 在两个写回回调(writeback 与 completion_writeback)间只包裹了前者,在实现层面造成写回门禁分裂,需要在本次 PR 内收口为统一写回校验并补齐跨平台单测。 当前 PR 已覆盖 Linux 启动期 Worker UID/GID/setpriv 降权、read-only/MCP 限制与单待办收尾写回校验,但尚未覆盖多待办非终结 validated_completion 的 completion_writeback 写回路径及不依赖 Linux root 的单元测试。

执行分支 terminal_closeout_required executor.py:1342-1351 调用回调 是否触发 isolated_codex_durable_writeback
单 Todo 收尾 / 非 validated_completion True(或非完成结果) writeback (codex_writeback) 是
多 Todo 非终结 validated_completion False completion_writeback(第 802 行未包裹) 否(直接绕过)

具体改动 / Changes

本 PR 在 docs/reference/protocols/loopx-turn-v0.md:1143-1144 追加了 18 行 Linux Worker 隔离说明,没有引用独立预编 RFC 或 Issue 规格(spec_basis=no_spec),故以 origin/main 既有的 Core Turn 准入与持久化写回契约为基线进行审查。全量变更共 7 个文件(+235/-11),涵盖 5 个运行时模块、1 个测试文件与 1 份协议文档。

关键代码讲解

  1. load_worker_identity(loopx/control_plane/turn_driver/codex_worker_identity.py:46-81):仅当 LOOPX_CODEX_OPERATION_WORKER_USER 或 LOOPX_CODEX_OPERATION_WORKER_HOME 非空时激活;校验运行于 Linux 且 geteuid()==0、Worker 账号 uid/gid != 0、私有 0o700 目录与 .codex 所有权、Core 拥有的不可写 registry_path 及隔离的 runtime_root、祖先目录不可被其他账号写入,以及系统标准路径下的 setpriv。
  2. run_codex_operation_turn(loopx/control_plane/turn_driver/codex_operation_host.py:77-162):加载 Worker 身份后拒绝非 read-only 沙箱、任何 mcp_server 覆盖与 legacy source admission,并将 {uid, gid} 与 codex_home 写入 profile_digest 再透传 worker_identity 给会话启动器。
  3. CodexChatAgentSession.start(loopx/chat_agent.py:766-1138):携手 codex_context.process_profile 短路隔离环境,强制 -c cli_auth_credentials_store="file",以 [worker_identity.setpriv, '--no-new-privs', '--', *command] 包裹命令并通过 Popen 参数降权,同时在 worker_identity is not None 时屏蔽 _LegacyModelCatalogSchemaError 回退。
  4. codex_writeback 与未包裹的 completion_writeback(loopx/cli_commands/turn_run_once.py:522-535,800-802 配合 executor.py:1342-1351):codex_writeback 对 writeback 检查了 isolated_codex_durable_writeback,但第 802 行传给执行器的 completion_writeback=completion_writeback 未经该包装。在多 Todo(如 2-Todo)Goal 上运行 validated_completion 时,executor.py 直接调用 completion_writeback,彻底跳过该检查。
  5. test_isolated_codex_worker_cannot_publish_or_override_core(tests/test_codex_operation_host.py:111-196):当前唯一新增测试,因 @pytest.mark.skipif(sys.platform != 'linux' or geteuid() != 0) 在 Darwin 和普通非 root Linux 上全部跳过,且仅测单 Todo fixture,未能捕获第 802 行漏洞。

对主干的风险 / Risks

P1 阻塞问题 1:多 Todo 非终结 validated_completion 绕过 isolated_codex_durable_writeback

  • 触发路径:在多 Todo Goal 上开启 --codex-operation-tools 及 Worker 隔离环境变量,且当前非终结 Todo 返回 result_kind='validated_completion'(terminal_closeout_required=False)。
  • 实测反事实证据:在隔离工作区构造 2-Todo 夹具执行真实 cli_main(['--format', 'json', ..., 'turn', 'run-once', '--codex-operation-tools', '--execute']) 并监测 FirstPartyHostGoalAdmission.require_running,观测到返回 RC: 0、STATUS: committed、EFFECTS: {'host_invoked': True, 'state_written': True, 'quota_spent': True, 'scheduler_acknowledged': False},而 REQUIRE_RUNNING_OPS 仅记录 ['codex_cli_turn_settle']——isolated_codex_durable_writeback 从未被调用,Core 状态与配额却已完成写回。
  • 最小修复:统一将 isolated_codex_durable_writeback 门禁同时覆盖 writeback 与 completion_writeback(并在事务计划/journal 层固化隔离标记而不只在提交瞬间临时读取 os.environ),补充多 Todo validated_completion 被已停止/重建 Goal 拒绝的回归测试。

P1 阻塞问题 2:新增隔离代码在 Darwin 与非 root 环境测试覆盖率为 0%

  • 触发条件:在 macOS 或普通无 root 权限 CI 节点运行 pytest。
  • 实测证据:tests/test_codex_operation_host.py:111-114 的唯一新增测试在本地跑测中全部 SKIPPED,导致 codex_worker_identity.py 的权限/祖先目录/uid/gid/环境变量拒绝逻辑、codex_operation_host.py 的沙箱与 MCP 拦截、chat_agent.py 的 setpriv/目录回退阻断以及 turn_run_once.py 写回隔离均无自动化平台无关单测覆盖。
  • 最小修复:保留 root-Linux 真实 setpriv 集成用例的同时,补全基于 mock/hermetic 的跨平台正负向单元测试,覆盖全部拒绝分支与双写回路径。

其他结构与兼容观测

  • Default-off 隔离性(isolated):未设置隔离环境变量时 worker_isolation_requested() 返回 False,现有 138 项 TS 测试与 204 项 Python 非隔离路径全部通过;在 Darwin 上主动配置隔离环境变量则会 fail-closed 抛出 ValueError。
  • 语义与权限命名(authority_semantics: misleading, semantic_alignment: not_applicable):由于 completion_writeback 会跳过 isolated_codex_durable_writeback,该操作名与协议文档所宣称的“所有隔离 Worker 写回前均复核 Goal 权威”尚不符;未改变跨仓库共享状态枚举,semantic-vocabulary-drift-smoke.py 已通过。

我的整体评价 / Verdict

PR #9129 提出的“Linux 进程降权 + Core 写回准入复核”方向合理,且未开启环境变量时保持了完全的 default-off 兼容;但核心写回守卫漏掉了最常见的多待办 completion_writeback 分支,且所有新增测试均被 Linux root 条件跳过,当前存在明确的功能漏检与回归盲区,需修改后重审。

  • Outcome Impact:long_horizon=not_yet_proven(多待办场景中 completion_writeback 跳过 isolated_codex_durable_writeback 会直接提交状态与配额);user_experience=preserved(默认路径不受影响,Darwin 开启时有明确报错)。visual_review:Inspected all 7 changed files (Python runtime/CLI modules, test_codex_operation_host.py, and docs/reference/protocols/loopx-turn-v0.md): no rendered UI or visual surface is altered.;unverified_scope:none。
  • 代码体量与架构评估:7 个文件 +235/-11,未引入新的共享状态枚举;兼容性影响 not_applicable;架构评估 simplify_now(需把 writeback 与 completion_writeback 的隔离校验合并收口)。
  • 验证汇总(精确 head c179a1eafa8cbb2a093b89e29b100c780ce2203d):
    • PASS:ruff check 通过;npm run typecheck:control-plane 通过;TS 测试(first_party_host_runtime.test.ts + turn_settlement.test.ts + turn_envelope.test.ts)138 passed, 0 failed;Python 6 个套件共 204 passed, 10 skipped;loopx check --scan-path 通过(errors=0,scanned_files=5205);loopx canary premerge --from-git-diff --git-diff-base origin/main 通过(selected=14, failures=0);Darwin 显式环境变量 fail-closed 反事实通过。
    • FAIL / SKIPPED:2-Todo validated_completion 实测反事实确认绕过 isolated_codex_durable_writeback(FAIL);test_isolated_codex_worker_cannot_publish_or_override_core[False|True] 在 Darwin 上全部 SKIPPED,Linux root 真实 setpriv 运行未在本机执行。
  • 重审所需证据:请提交(1)将 isolated_codex_durable_writeback 同时接入 writeback 与 completion_writeback(或统一写回拦截点)的新精确 head,(2)不依赖 Linux root 的跨平台单元测试,覆盖多 Todo validated_completion 写回拦截及 codex_worker_identity/codex_operation_host/chat_agent 负向用例。

English verdict: REQUEST_CHANGES

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants